home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1995 November / EnigmA AMIGA RUN 02 (1995)(G.R. Edizioni)(IT)[!][issue 1995-11][Skylink CD].iso / earcd / util / misc / und64_37.lha / und64.doc < prev   
Text File  |  1995-01-28  |  10KB  |  298 lines
  1. UNd64 v 37.7 (28.1.95)
  2. © Copyright 1994-1995 Jess Sosnoski
  3.  
  4.  
  5. DISCLAIMER:
  6. ----------
  7. Use this program at your own risk!
  8. I assume no responsibility or liability for problems that occour by the use,
  9. modification, or existence of this product in any form.
  10. (I.E. If it destroys all but 880K of your 1.2G Harddrive,switch to floppies)
  11.  
  12. This program is copyrighted by Jess Sosnoski and is available as shareware.
  13. It may be distributed only under the following conditions:
  14. 1.)    Program and Documentation is not modified in any way.
  15. 2.)    Program and Documentation must be distributed together.
  16. 3.)    This package may not be used for commercial purposes.
  17.     Without my permission.
  18. 4.)    Sale price must not exceed the cost of media and shipping plus a
  19.     nominal copying fee equaling no greater than fred fish charges.
  20. 5.)    I give permission to release this on CD-ROM. (especially Aminet)
  21.  
  22.  
  23. DESCRIPTION
  24. -----------
  25. This program is designed to extract files from .d64 disk images found at
  26. WATSON.MBB.SFU.CA, and PeeCee C64 emulator diskimage files.
  27.  
  28. REQUIREMENTS
  29. ------------
  30. An Amiga with kickstart 1.1+ (I don't have 1.0 so I can't test it on that)
  31. about 180K free ram, .d64 diskimages, and any type of amiga-compatible
  32. disk drive that will hold a .d64 diskimage.
  33.  
  34. WHAT ARE .D64 DISK IMAGES?
  35. --------------------------
  36. .d64 files are the sector-by-sector contents of a Commododore 1541 formatted
  37. disk.
  38. These files are commonly used by PeeCee C-64 emulators to store c-64 files,
  39. and to xfer 1541 disks into a convenient method of storage for use by the
  40. emulators.
  41. Unfortunately, none of our Amiga C-64 emulators cant take advantage of this.
  42. (HINT! HINT! Questronix/A-64!!!)
  43. This program reads in the archive file and allows one to extract,list or
  44. test the files within the archive.
  45. There also exists an archive on aminet that allows one to create .d64
  46. archives on a 5.25" drive equipped Amiga.  The archive also contains a
  47. program for dearcing files from .d64 archives.
  48. (I believe it's in misc/emu/1541.lha)
  49.  
  50. USAGE
  51. -----
  52. From the Shell/CLI (only):
  53. und64 [command]{option} [filename]
  54.  
  55. If run withour parameters, usage information will be displayed.
  56. Commands:
  57. l List files in Archive.
  58. x Extract files from archive.
  59. t Test files in archive.
  60.  
  61. Options:
  62. d Handle DELeted files
  63. * WARNING * Resurrecting DELeted files is risky business, if a new file
  64.         is partially written over part of a DEL'd file, you may also
  65.         get the end of another file as a surprise bonus. Or maybe
  66.         you'll just get a part of an already complete file.
  67. a Handle ALL files.  This will allow extracting of splat files, or
  68.   in other words, incorrectly closed files. Same warning as DEL files.
  69.  
  70. Filename:
  71. Name of the file including the .d64 extension (if exists).
  72.  
  73.  
  74. Example:
  75. und64 la FooBar.d64
  76.  
  77. Example Output:
  78.  
  79. UNd64 37.7 (28.1.95)
  80. © Copyright 1995 Jess Sosnoski / Paradigm Shift Software
  81. Reading file...
  82.  
  83. Disk Name:games_____________04_2a
  84.      Approx
  85. Blks  Bytes Type Filename
  86. ---------------------------------
  87.    1    254  PRG         star
  88.   66  16764  PRG    czar trek
  89.  154  39116  DEL    hhm.0801-9ff0
  90.    1    254  DEL    hhm.9ff0-a000
  91.    1    254  DEL    hhm.c000-c080
  92.    1    254  DEL     hard hat
  93.   66  16764  PRG         kong
  94.    1    254  PRG    kong boot
  95.    3    762  DEL         root
  96.   33   8382  DEL        qfm96
  97.    2    508  DEL     centipod
  98.    9   2286  DEL        turbo
  99.  
  100.  
  101. Output Description
  102. ------------------
  103. Blocks: number of disk blocks it took up on the disk.
  104.     A disk block=256 bytes, 254 used for data.
  105. Approx Bytes: 254*Blocks.  This is to give an approximate filesize
  106.           Actual filesize should be smaller than or equal to this.
  107.             NOTE: If someone messed with the dir structure and
  108.               manually changed the number of blocks, this could
  109.               give false information. If blocks>664, which is
  110.               physically impossible, the length is set to 0.
  111. Type:  This will be DEL, PRG, SEQ, or USR.  This is for informational
  112.        purposes only, and does not affect outputted files.  For those of you
  113.        out there who are not Commodore users, PRG files are typically
  114.        programs/executables.  SEQ files are typically text files.  USR
  115.        can be about anything.  DEL files are deleted, you can list or
  116.        attempt to extract them when using the d option.
  117.        There are also REL(ative) files, which are not supported.
  118.        REL files are 3-d type files with all kinds of side sectors
  119.        and records and junk--so I chose not to deal with them.
  120.        (as if they could be properly stored on a filesystem which does
  121.        not support them!)
  122.  
  123. Filename: Gee, I dunno.
  124.     NOTE: Filenames are converted to AmigaASCII, and any characters
  125.     <32 or >127 are converted to printable characters.
  126.     Characters /"?:#*, are converted to -
  127.  
  128. At any point during program execution, pressing CTRL-C will abort.
  129.  
  130. Output Messages
  131. ---------------
  132. ***Break
  133. You pressed CTRL-C and stopped execution.
  134.  
  135. * Extracting
  136. File is being extracted.
  137.  
  138. * Testing
  139. File is being tested for integrity
  140.  
  141. >>Extracting/Testing Errors:
  142.  
  143. * Not a .d64 archive!!
  144. The filelength wasn't EXACTLY 174848 bytes, and given that all valid
  145. .d64 archives are of that length, nothing else is acceptable.
  146. However, if you have a file of exactly that length, you can fool the
  147. program (results should be interesting).
  148.  
  149. * Circular Link Found, File Truncated
  150. UNd64 found a circular link and cut the file off there.
  151. A circular link occours when a pointer to the next track & sector of a file
  152. points to a track & sector earlier in a file, which can cause an infinite
  153. loop (not good).
  154.  
  155. * File size error (n bytes)
  156. This is either caused by circular links, inproper file size in the
  157. directory block, or a corrupt file (possible disk error).  The number
  158. in parenthesis is the number of bytes the file actually was.
  159.  
  160. * File Exists! (R)ename (O)verwrite (S)kip (A)bort
  161. If a file already exists with the same name, this message appears.
  162. At this point you would select the first letter of the appropriate option
  163. and press return. Rename will ask you for a new name to give the file,
  164. Overwrite will overwrite the file, Skip will skip extracting the file, and
  165. Abort will stop the program A-la CTRL-C.
  166.  
  167. COMPATIBILITY
  168. -------------
  169. This program was written and compiled on an A600 running 2.06 (37.350) rom,
  170. and 2.1 workbench with 4MB Fast 2MB Chip, and a 120MB hard drive.
  171. Tested on:
  172. A600    2Chip        1.3/1.3
  173. A600    2Chip 4Fast    2.06/2.1
  174. A600    2Chip 4Fast    3.0/3.0
  175. A1000    512K Chip    1.1,1.2,1.3
  176.  
  177. ...And it worked on all of them, but bug reports are still welcome.
  178. (I know it needs at least ~180K free memory to run)
  179.  
  180.  
  181. NOTES
  182. -----
  183. Some .d64 files do not have fully extractable programs on them.
  184. You may be able to extract the boot file(s), but other than that,
  185. you will need a virtual .d64 device.
  186. Some examples of disks that may do this would be flight simulator disks,etc.
  187. There is a possibility that listing problems may occur if the directory
  188. blocks are moved from track 18 (where they SHOULD be).    I'm too lazy to
  189. change a couple of lines, but if it becomes a problem, let me know.
  190. This should not affect testing or extraction.
  191.  
  192.  
  193. BENCHMARKS
  194. ----------
  195. Command        Versions/Time in Seconds
  196.         37.5        37.6+    Factor
  197. ----------------------------------------------
  198. l (list)    9        3    ~300%
  199. t (test)    28        6    ~466%
  200. x (extract)    54        23    ~235%
  201. Tested on archive commodor.d64 from watson.mbb.sfu.ca.
  202. Results may vary depending on archive and machine.
  203.  
  204.  
  205. HISTORY
  206. -------
  207. 37.1        First Release.    Written and compiled in PCQ Pascal 1.2d
  208.         (the PD release), assembled on A68k 2.71, disassembled
  209.         with IRA 1.02, re-assembled and optimized with PhxAss 3.30,
  210.         linked throughout with PhxLnk 2.03, and hunkmerged with
  211.         Imploder 4.0.
  212.         Basically, it does what is says it does.
  213.         It has a styleguide-compliant version string.
  214.         (or seems to be)
  215.  
  216. 37.2        Added circular-link checking and fixed a ctrl-c bug when
  217.         attempting to break while extracting (37.1 didn't stop).
  218.         Unfortunately c-l checking slows down extraction a wee bit.
  219.         Fixed REL file bug, it no longer lists or attempts to extract
  220.         these nasty little files.  Improved illegal filename character
  221.         checking.  Rewrote some parts of this doc.
  222.  
  223. 37.3        Speeded up circular-link check to take constant time O(1),
  224.         instead of summatory time, improved output.  Added duplicate
  225.         filename checking.  Improved illegal filename character checking.
  226.         Rewrote some more of the doc.
  227.  
  228. 37.4        Now primarily assembled with SNMA 1.39 instead of A68K, and
  229.         re-assembled & optimized with Phxass 3.71, producing shorter
  230.         faster code.  Added ability to process deleted and splat files,
  231.         put some filesize checking in.
  232.  
  233. 37.5        Assembled with SNMA 1.95, and skipped Phxass because it's
  234.         optimization was causing GURU's-and I didn't want to mess
  235.         with the program to get it to work at 3am.  Added file
  236.         testing, support for locked, etc.. files, removed a few bugs,
  237.         rewrote some parts of code.  Improved output.
  238.  
  239. 37.6        Assembled and optimized with SNMA 1.97.  Rewrote reading/
  240.         writing routines for a MAJOR speed increase.  Rewrote
  241.         parts of doc.
  242.  
  243. 37.7        Added archive filesize checking in for almost perfect
  244.         .d64 archive recognition.
  245.         
  246. TODO
  247. ----
  248. -SAS/C (when I can afford it)
  249. -Wildcard extraction
  250. -AmigaGuide docs (When I get a GOOD,easy amigaguide-writing program)
  251. -.t64 file processing
  252. *I am currently rewriting the entire program in Modula-2, which supports
  253.  2.x+, therefore I will be writing the program to be 2.x+ only, which
  254.  should result in a speed increase and other features (listed above).
  255.  The worst thing that can happen may be a slight change in command syntax.
  256.  It's also likely that I'll include the last version of this program for
  257.  all you 1.3- die-hards.
  258.  
  259. HARDER things TO DO
  260. -------------------
  261. -Make it possible to create/modify .d64 diskimage files.  Copying files both
  262.  from and to, renaming, deleting, etc...
  263. -Make the above into a virtual disk .d64filesystem so that any program can
  264.  make diskimages that may be xferred to C-64's & emulators.
  265. -Repair circular links (so the whole file can be extracted).
  266.  
  267. The Author's Addresses...
  268. -------------------------
  269. Jess Sosnoski
  270. 651 Hillside Drive
  271. Mount Carmel, PA  17851-2463
  272. USA
  273.  
  274. My Internet address (unless I'm put on another machine or I leave school):
  275. j8s@mc3b2.bloomu.edu
  276. and
  277. jlsosn@planetx.bloomu.edu
  278. (latter preferred)
  279.  
  280. If you feel the irresistible need to send me money, gifts or an
  281. Amiga 4000 Tower, I will give you a very gracious thank you.
  282.  
  283.        //
  284.       //  .
  285.      //  /|
  286.  \\ //    /_|
  287.   \x/ _/ _|MIGA...uh, when somebody wins it, let me know.
  288.  
  289. Quote of the day:
  290. "Just takin' it easy..."
  291.             -Uncle Leo
  292. Runner Up:
  293. "How 'bout it!"
  294.         -Gary
  295.  
  296.  
  297.  
  298.